Kuboard v3安装

官网地址：https://kuboard.cn/install/v3/install.html#kuboard-v3-x-版本说明

一、Kuboard介绍

Kuboard 是一个用于 Kubernetes 集群管理的工具，提供了用户友好的界面和管理功能。主要特点包括：

可视化管理：通过图形化界面帮助用户更轻松地管理 Kubernetes 集群，包括应用部署、资源管理、日志查看等。
集群监控：提供集群和应用的实时监控功能，帮助用户了解集群的健康状态和性能指标。
简化操作：简化了 Kubernetes 的复杂操作，例如应用部署、服务管理、滚动更新等，降低了操作难度。
多集群支持：支持管理多个 Kubernetes 集群，方便用户集中管理和操作。
用户权限管理：支持细粒度的权限控制，确保集群资源和操作权限得到合理分配。

Kuboard 适用于需要管理 Kubernetes 集群的用户，尤其是那些希望通过更友好的界面来简化集群管理任务的用户。

二、兼容性

Kubernetes 版本	Kuboard 版本	兼容性	说明
v1.28	v3.5.2.x	😄	已验证
v1.27	v3.x	😄	已验证
v1.26	v3.x	😄	已验证
v1.25	v3.x	😄	已验证
v1.24	v3.x	😄	已验证
v1.23	v3.x	😄	已验证
v1.22	v3.x	😄	已验证
v1.21	v3.x	😄	已验证
v1.20	v3.x	😄	已验证
v1.19	v3.x	😄	已验证
v1.18	v3.x	😄	已验证
v1.17	v3.x	😄	已验证
v1.16	v3.x	😄	已验证
v1.15	v3.x	😄	已验证
v1.14	v3.x	😄	已验证
v1.13	v3.x	😄	已验证
v1.12	v3.x	😐	Kubernetes Api v1.12 不支持 dryRun， Kuboard 不支持 Kubernetes v1.12
v1.11	v3.x	😐	Kuboard 不支持 Kubernetes v1.11

三、安装方式

基于如下原因，建议您以 docker run 的方式运行 Kuboard：

结构更清晰（Kuboard 作为多个集群的管理界面应该独立于任何集群之外，虽然安装在 Kubernetes 集群中的 Kuboard 也可以管理多个集群）；
登录 Kuboard 时使用不同的认证方式；
问题排查更简单；

请参考：

四、使用内建用户库认证安装

4.1 部署计划

在正式安装 kuboard v3 之前，需做好一个简单的部署计划的设计，在本例中，各组件之间的连接方式，如下图所示：

假设用户通过 http://外网IP:80 访问 Kuboard v3；
安装在 Kubernetes 中的 Kuboard Agent 通过 内网IP 访问 Kuboard 的 Web 服务端口 80 和 Kuboard Agent Server 端口 10081。

安装 Kuboard 之前，假设：

您已经准备好了一个 Linux 服务器用于安装 Kuboard-V3，并且该机器上的 docker 版本不低于 19.03
用于安装 Kuboard v3.x 的机器已经安装了 docker，并且版本不低于 docker 19.03
您已经有自己的 Kubernetes 集群，并且版本不低于 Kubernetes v1.13

4.2 安装

安装 Kuboard v3.x 版本的指令如下：

sudo docker run -d \
  --restart=unless-stopped \
  --name=kuboard \
  -p 80:80/tcp \
  -p 10081:10081/tcp \
  -e KUBOARD_ENDPOINT="http://内网IP:80" \
  -e KUBOARD_AGENT_SERVER_TCP_PORT="10081" \
  -v /root/kuboard-data:/data \
  eipwork/kuboard:v3
  # 也可以使用镜像 swr.cn-east-2.myhuaweicloud.com/kuboard/kuboard:v3 ，可以更快地完成镜像下载。
  # 请不要使用 127.0.0.1 或者 localhost 作为内网 IP \
  # Kuboard 不需要和 K8S 在同一个网段，Kuboard Agent 甚至可以通过代理访问 Kuboard Server \

DANGER
KUBOARD_ENDPOINT 参数的作用是，让部署到 Kubernetes 中的 kuboard-agent 知道如何访问 Kuboard Server；
KUBOARD_ENDPOINT 中也可以使用外网 IP；
Kuboard 不需要和 K8S 在同一个网段，Kuboard Agent 甚至可以通过代理访问 Kuboard Server；
建议在 KUBOARD_ENDPOINT 中使用域名；
如果使用域名，必须能够通过 DNS 正确解析到该域名，如果直接在宿主机配置 /etc/hosts 文件，将不能正常运行；

参数解释
建议将此命令保存为一个 shell 脚本，例如 start-kuboard.sh，后续升级 Kuboard 或恢复 Kuboard 时，需要通过此命令了解到最初安装 Kuboard 时所使用的参数；
第 4 行，将 Kuboard Web 端口 80 映射到宿主机的 80 端口（您可以根据自己的情况选择宿主机的其他端口）；
第 5 行，将 Kuboard Agent Server 的端口 10081/tcp 映射到宿主机的 10081 端口（您可以根据自己的情况选择宿主机的其他端口）；
第 6 行，指定 KUBOARD_ENDPOINT 为 http://内网IP，如果后续修改此参数，需要将已导入的 Kubernetes 集群从 Kuboard 中删除，再重新导入；
第 7 行，指定 KUBOARD_AGENT_SERVER 的端口为 10081，此参数与第 5 行中的宿主机端口应保持一致，修改此参数不会改变容器内监听的端口 10081，例如，如果第 5 行为 -p 30081:10081/tcp 则第 7 行应该修改为 -e KUBOARD_AGENT_SERVER_TCP_PORT="30081"；
第 8 行，将持久化数据 /data 目录映射到宿主机的 /root/kuboard-data 路径，请根据您自己的情况调整宿主机路径；

其他参数
在启动命令行中增加环境变量 KUBOARD_ADMIN_DERAULT_PASSWORD，可以设置 admin 用户的初始默认密码。

4.3 访问 Kuboard v3.x

在浏览器输入 http://your-host-ip:80 即可访问 Kuboard v3.x 的界面，登录方式：

用户名： admin
密码： Kuboard123

Kuboard v3安装 ​

一、Kuboard介绍 ​

二、兼容性 ​

三、安装方式 ​

四、使用内建用户库认证安装 ​

4.1 部署计划 ​

4.2 安装 ​

4.3 访问 Kuboard v3.x ​